[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
##############################################################################
###+--------+#################################################################
#+-| LEFT() |--------------------------------------------+####################
#| +--------+ Returns the specified number of characters |####################
#+-------------------------------------------------------+####################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |-----------------------------------------------------+##########
#|     FUNCTION CHAR left PROTOTYPE                                |##########
#|      PARAMETERS CONST CHAR source_string, VALUE UINT number     |##########
#+-----------------------------------------------------------------+##########
##############################################################################
##############################################################################
###########+---| Description |-----------------------------------+############
###########| The left() function returns the specified number of |############
###########| characters from source_string starting at the first |############
###########| character.                                          |############
###########+-----------------------------------------------------+############
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########|                                                          |#########
#########| ? left( "Susan Jones",3)          && Prints "Sus"        |#########
#########| ? len(left( "Molly Bergen",200))  && 12, not 200         |#########
#########| ? len(left(space(100)))           && Prints 0            |#########
#########| ? left( "   Start ",4)            && Prints "   S"       |#########
#########+----------------------------------------------------------+#########
##############################################################################

See Also: len() ltrim() right() rtrim() substr()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson